home *** CD-ROM | disk | FTP | other *** search
/ The 640 MEG Shareware Studio 2 / The 640 Meg Shareware Studio CD-ROM Volume II (Data Express)(1993).ISO / dbase / vision51.zip / VISION.DOC < prev    next >
Text File  |  1992-10-05  |  41KB  |  1,178 lines

  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.                                 VISION   SYSTEM
  11.                                =================
  12.                               (v 5.1 01-Oct-1992)
  13.                                       by
  14.                               Maurizio  Ammannato
  15.                           (R) 1992  Maurizio's House
  16.  
  17.  
  18.  
  19.  
  20.  
  21. Welcome to VISION System
  22. ========================
  23. Vision  is  a  Free  Form Textual Data Base System. The first access method is
  24. the  usual  hierarchical  Chapter/Pages two-levels access. In this way you can
  25. read  newspaper  articles,  documents,  books,  dictionaries, glossaries, help
  26. files  ,etc.)  just  choosing  the Data Base you want read (first layer), then
  27. its  Chapters  (second layer), finally the chapter Pages (third layer). Or you
  28. can  access  a  VISION  Data  Base using HypertText technique, thus navigating
  29. text  through  its  key-words  (fourth layer). This package allow you to build
  30. your own Text Data Base by yourself. It isn't not just a "Read Only" package.
  31.  
  32.  
  33.  
  34.  
  35. Licence Fee
  36. ===========
  37. The  package  is completely free of charge for personal use. Do as many copies
  38. you  like  for you and your friends. However you don't have to sell it or make
  39. any  kind  of  profit.  Any  commercial  use of VISION must be agreed with the
  40. Author.
  41.  
  42.  
  43.  
  44.  
  45.  
  46. MY PREFERRED SENTENCE
  47. =====================
  48. "It's  hard  to  believe  that  good people are still the Silent Engine of the
  49. World  as  it is to believe that under the dirty sea surface a large and clean
  50. world  really  exists.  Unfortunately  this  Appearance  bombs  constantly our
  51. senses; fortunately it is a very small part of the Entire."
  52.                                                          (Oiziruam Otannamma)
  53.  
  54.  
  55.  
  56.  
  57. Enjoy VISION System !
  58.  
  59.  
  60.  
  61.  
  62.  
  63.  
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.  
  71.  
  72.                                                          Maurizio Ammannato
  73.                                                           Via Preguda N.60
  74.                                                         22049 Valmadrera (CO)
  75.                                                         ---------------------
  76.                                                               I T A L Y
  77.  
  78.  
  79.  
  80.  
  81.  
  82. Decompressing Archives
  83. ======================
  84. Create  a  directory  called VISION (DOS command MD) and copy there VISION.ZIP
  85. file  and  eventually  all  related  Textual Data Base with the extension .ZIP
  86. (which means compressed via PKZIP.EXE utility).
  87.  
  88. Using  the  companion  PKUNZIP.EXE  utility  (which  you can find on many BBS)
  89. decompress them as following :
  90.  
  91.  
  92.                             C:\VISION\pkunzip *.zip
  93.  
  94.  
  95. In this way all .ZIP archives will be 'unzipped'.
  96.  
  97.  
  98. The VISION package must have the following files :
  99.  
  100.  
  101. - VISION.EXE             engine program
  102. - VIS_OVL.EXE            its overlay
  103. - VIS_CRE.EXE            create your own Textual Data Base (import)
  104. - VIS_UPD.EXE            from .DB database back to .UPD ASCII file (export)
  105. - VIS_SORT.EXE           sort utility
  106. - VIS_FONT.EXE           change VGA screen text font
  107. - VISION.CFG             configuration file (default=color)
  108. - VISION.COL             configuration file for color monitor
  109. - VISION.BW              configuration file for mono monitor
  110. - VISION.MSG             comment/help file for VISION.EXE (default=English)
  111. - VIS_OVL.MSG            comment/help file for VIS_OVL.EXE (default=English)
  112. - VISION.ENG             VISION.EXE comment file in English
  113. - VIS_OVL.ENG            VIS_OVL.EXE comment file in English
  114. - VISION.ITA             VISION.EXE comment file in Italian
  115. - VIS_OVL.ITA            VIS_OVL.EXE comment file in Italian
  116. - VISION.DOC             VISION documentation in printable format (English)
  117. - #_VISION.NDX           documentation in VISION format (INDEX)
  118. - #_VISION.DB            documentation in VISION format (DB)
  119. - WHATIS.NEW             brief description of new features
  120.  
  121. Demo files:
  122.  
  123. - VISION.DDD             example file for VISION.DIR option
  124. - #_PIPPO.UPD            example source file to build new VISION DB
  125. - #_PLUTO.UPD            example source file to build new VISION DB with
  126.                          HyperText facility
  127.  
  128.  
  129.  
  130. Decompress  all  .ZIP Textual Data Bases (TDB) you have in the directory using
  131. the  same  procedure  as  before;  after that copy all .ZIP files in a back-up
  132. device and REMOVE all .ZIP (i.e. "ERASE *.ZIP") to save precious disk space.
  133.  
  134.  
  135.  
  136.  
  137.  
  138. VISION Configuration
  139. ====================
  140. Check  through  your  favorite  Text  Editor  or  WP  the  configuration  file
  141. VISION.CFG and change what you need or wish to change.
  142.  
  143.  
  144. Foreground  color numbers can range from 1 to 31 (after number 15 the color is
  145. blinking). Background from 1 to 7.
  146. The following is the complete list of options you can set :
  147.  
  148.  
  149.  
  150. '---------------------------------- VISION.CFG config file
  151. SCROLL_SPEED=7     number of secs for automatic scrolling
  152. SORT=BYNAME        or BYDATE or NO sort option
  153. EDITOR=filename    full path of your preferred Text Editor (Alt-E)
  154. WDW_END=@@@        break-characters for Keyword Windows
  155. SKD_LFT=60         source keyword left delimiting character
  156. SKD_RGT=62         source keyword right delimiting character
  157. TKD_LFT=17         target keyword left delimiting character
  158. TKG_RGT=16         target keyword right delimiting character
  159. F_DBW=15           foreground Data Base Window (DBW) color
  160. B_DBW=7            background Data Base Window (DBW) color
  161. F_BOT=0            foreground Help Desk color
  162. B_BOT=2
  163. F_COM=0            foreground DBW comment line
  164. F_HIG=14           foreground DBW data base name
  165. F_DBR=10           foreground DBW highlighted DB name
  166. B_DBR=1            background DBW highlighted DB name
  167. F_IDX=15           foreground Index Window (IW) color
  168. B_IDX=1
  169. F_TDX=7            foreground IW text color
  170. B_TDX=1
  171. F_DOC=0            foreground Document Text color
  172. B_DOC=7
  173. F_REV=0            foreground reverse Index title
  174. B_REV=6
  175. F_ASK=15           input window
  176. B_ASK=4
  177. F_FND=14           founded string color
  178.  
  179.  
  180.  
  181.  
  182. Color or Monochrome
  183. ===================
  184. You can easily change color attributes modifying .CFG file color parameters.
  185.  
  186. To  make  your  life  easier,  if  you have a monochrome screen, copy directly
  187. VISION.BW to VISION.CFG file using DOS COPY command:
  188.  
  189.  
  190.                       C:\VISION\COPY vision.bw vision.cfg
  191.  
  192.  
  193.  
  194.  
  195.  
  196. VISION.MSG Message file
  197. =======================
  198. Edit  also  VISION.MSG  messages  file  and change what you need (i.e. from my
  199. Italian English to Queen's English, etc.)
  200.  
  201. To change language file use COPY DOS command :
  202.  
  203.  
  204.                      C:\VISION\COPY vision.ita vision.msg
  205.  
  206.  
  207. to   have   the   Italian  comments/help.  You  can  obviously  create  a  new
  208. comment/help file with your own language; i.e. for Spanish :
  209.  
  210. - copy VISION.ENG into a new file VISION.ESP (DOS "COPY
  211.   VISION.ENG VISION.ESP")
  212.  
  213. - modify the new file with Spanish translation using a TE or
  214.   WP (Text Editor or Word Processor)
  215.  
  216. - copy new VISION.ESP into VISION.MSG (c:\vision\COPY VISION.ESP VISION.MSG)
  217.  
  218.  
  219.  
  220.  
  221.       ==================================================================
  222.       New comment strings MUST MUST have the same LENGTH of the old ones
  223.       ==================================================================
  224.  
  225.  
  226.  
  227.  
  228.  
  229. Executing VISION
  230. ================
  231. Before  executing VISION for the first time, verify to have available at least
  232. one  TDB  (Textual  Data Base) with both .DB and .NDX files. You must at least
  233. have  VISION  files.  You  can  create  a  new  one by yourself (see below) or
  234. download  some  from a BBS. Remember to decompress them if ZIPped as explained
  235. before.
  236.  
  237.  
  238. You have two different ways to execute VISION.
  239.  
  240. 1)  MENU  MODE.  Typing  VISION at DOS prompt, you enter into Main Menu Window
  241. with the list of available Data Bases (see below):
  242.  
  243.                                C:\VISION>vision
  244.  
  245.  
  246. 2)  COMMAND  LINE  MODE.  Typing VISION followed by data base name at DOS line
  247. prompt,  you  enter directly into Index Menu from which, using ESCape command,
  248. you come back directly to DOS :
  249.  
  250.                             C:\VISION>vision b_netw
  251.  
  252.  
  253.  
  254. If  you  have  a  VGA  monitor  you  can  execute vision typing VGA instead of
  255. VISION.  This  allows  VISION  to  load into PC ROM a new text font (modern-d)
  256. resulting in a more readable text:
  257.  
  258.                                  C:\VISION>vga
  259.  
  260.  
  261.  
  262. Also  in  this  case  you  can  enter directly into the Index Menu writing VGA
  263. followed by data base name:
  264.  
  265.                             C:\VISION>vga #_vision
  266.  
  267. to have on line VISION documentation.
  268.  
  269.  
  270.  
  271.  
  272.  
  273. VISION Data Base Structure
  274. ==========================
  275. Before  going  on  it's  a good idea to define the Textual Data Base structure
  276. used by VISION.
  277.  
  278.  
  279.                       **********************************
  280.                       A VISION Data Base has FOUR layers
  281.                       **********************************
  282.  
  283.  
  284. 1) Data Base Layer (list of all available Data Bases names, up to 100)
  285. 2) Title Layer     (list of all Data Base Titles, no limit)
  286. 3) Page Layer      (text pages of selected Title, no limit)
  287. 4) Keyword Layer   (window text on selected word, no limit for keyword
  288.                     number, 16 windows in depth for each keyword)
  289.  
  290.  
  291. Two examples
  292. ------------
  293.  
  294. #_VISION Data Base:
  295. . Name, comment, creation date and size => Data Base LAYER (1st)
  296. . Chapter titles                        => Title LAYER (2nd)
  297. . Vision document Pages                 => Page LAYER (3rd)
  298.  
  299. N_GLOSSA Data Base:
  300. . Name, comment, creation date and size => Data Base LAYER (1st)
  301. . Glossary Terms                        => Title LAYER (2nd)
  302. . Term Description                      => Page LAYER (3rd)
  303. . Keyword Comment                       => Keyword LAYER (4th)
  304.  
  305.  
  306.  
  307.  
  308.  
  309. Main Menu Window
  310. ================
  311. In  the  Main Menu, you can see at the same time up to 15 available Data Bases
  312. with  related  comment,  last update data and size. The limit of available TDB
  313. is 100 Data Base. Press Alt-H keys to get an on line help.
  314.  
  315.                        ********************************
  316.                        Alt-H to get VISION on line HELP
  317.                        ********************************
  318.  
  319.  
  320.                    Help - MAIN MENU Available Commands (1st)
  321.                    =========================================
  322.  
  323.     Alt-B  Build New Data Base                     PgDn  Page Down
  324.     Alt-C  Change Data Base Comment Line           PgUp  Page Up
  325.     Alt-D  Delete Data Base                             Title Up
  326.     Alt-E  Edit Source ASCII file (.UPD)                Title Down
  327.     Alt-R  Restore Original Index                  Home  Top of List
  328.     Alt-S  Sort Title Index Ascending              End   Bottom of List
  329.     Alt-T  Sort Title Index Descending             ─┘   Open Data Base
  330.     Alt-U  Rebuild ASCII UPD file (EXPORT)         ESC   Exit
  331.  
  332.  
  333.  
  334. Use  Up/Down  arrows or PgUp/PgDn to navigate, Alt-H for on-line help. Once on
  335. the  line of chosen DB (highlighted color) the ENTER key allow you to open the
  336. Title Menu (you enter into 2nd layer).
  337.  
  338.                     ***************************************
  339.                     ENTER key to OPEN highlighted Data Base
  340.                     ***************************************
  341.  
  342.  
  343. Initially  TDB  Titles  are  indexed  sequentially  (first record found, first
  344. record  in  DB).  You  have two possibilities to change the indexing method by
  345. pressing  ALT-S  or  ALT-T  keys.  These  two  commands  tell  VISION  to sort
  346. highlighted  index  by  alphabetical  ascending  (ALT-S) or descending (ALT-T)
  347. order.
  348.  
  349.                   *******************************************
  350.                   Alt-S Alt-T to index differently Title list
  351.                   *******************************************
  352.  
  353.  
  354.  Any way Alt-R option restores the original indexing method.
  355.  
  356.                    *****************************************
  357.                    Alt-R to RESTORE original indexing Method
  358.                    *****************************************
  359.  
  360.  
  361.  
  362.  
  363.  
  364. From  Main  Menu  you  can directly edit a new/old VISION source .UPD file. To
  365. use  this option you have to declare before, in VISION.CFG file, the preferred
  366. Text  Editor FULL PATH and EXTENSION. Then, non depending on which highlighted
  367. name  you  are,  press  together Alt-E keys and give the filename WITHOUT .UPD
  368. extension.  If  you  use  an editor called QEDIT, in \EDITORS\ directory on D:
  369. device, write in your VISION.CFG the following path:
  370.  
  371. ...........................
  372. EDITOR=D:\EDITORS\QEDIT.EXE
  373. ...........................
  374.  
  375.                      ************************************
  376.                      Alt-E to EDIT source ASCII .UPD file
  377.                      ************************************
  378.  
  379.  
  380. From  Main  Menu  you  can  also  directly  build  a new VISION Data Base. Non
  381. depending  on  which  highlighted  name you are, press together Alt-B keys and
  382. give  the  New data base name WITHOUT .UPD extension (you must have this ASCII
  383. file on VISION directory).
  384.  
  385.                     **************************************
  386.                     Alt-B to CREATE new Data Base (IMPORT)
  387.                     **************************************
  388.  
  389.  
  390. You  can also rebuild the original .UPD ASCII file from main Menu, 1) move the
  391. bar  on  the  Data  Base  name  then  2)  press  Alt-U.  You  are required for
  392. confirmation.
  393.  
  394.                   ******************************************
  395.                   Alt-U to REBUILD source .UPD file (EXPORT)
  396.                   ******************************************
  397.  
  398.  
  399. To  delete  an  existing Data Base, move the bar up to selected Data Base name
  400. and  press Alt-D keys. Before removing highlighted Data Base, you are required
  401. to  confirm that. This command DOESN'T cancel the related .UPD source file but
  402. only .DB, .NDX and .KEY files.
  403.  
  404.                      *************************************
  405.                      Alt-D to DELETE highlighted Data Base
  406.                      *************************************
  407.  
  408.  
  409.  
  410.  
  411.  
  412. Title Window
  413. ============
  414. Once on TITLE Window, press Alt-H keys to get the following on line Help :
  415.  
  416.  
  417.                    Help - TITLE WINDOW Available Commands (2nd)
  418.                    ============================================
  419.  
  420.     PgDn/Up Page Down/Up                /       Title Up/Down
  421.     Alt-H   This Help                   Home/End  Top/Bottom List
  422.     F1      Search String               F9        Search String Globally
  423.     F2      Search Again                F10       Global Search Again
  424.     ─┘     Open Document               ESC       Exit
  425.  
  426.  
  427. Use Up/Dn arrows and PgUp/PgDn keys to navigate this list.
  428.  
  429. If  you  have  a  long list you can use F1 key to quickly search the title you
  430. need,  F2  to  search  again.  You  can  search also for a piece of word, i.e.
  431. "etw".  In this case all words having "etw" will be displayed. F2 search again
  432. using same search string.
  433.  
  434.                  *********************************************
  435.                  F1/F2 keys to SEARCH a word in the Title list
  436.                  *********************************************
  437.  
  438.  
  439. Using  F9/F10  you search instead for words line per line across documents. An
  440. example.  Let  imagine  you  want  to  search  the  word "disciple" in the New
  441. Testament.
  442.  
  443. 1) be in New Testament index window (Title level)
  444. 2) press F9 and give search string "disciple"
  445. 3) VISION finds search string in a book title
  446. 4) enter in the book (ENTER key)
  447. 5) press F2 to search same string inside the document
  448. 6) press ESC to come back to Index window
  449. 7) press F10 to search again at book title level (index)
  450.  
  451. The  difference  between two above searching methods is that F1/F2 keys search
  452. the  string  within  the  index  comment line (Index level), while F9/F10 keys
  453. search the string in the entire Data Base.
  454.  
  455.              ****************************************************
  456.              F9/F10 keys to SEARCH a word in the ENTIRE Data Base
  457.              ****************************************************
  458.  
  459.  
  460.  
  461. Opening Document
  462. ----------------
  463. Move  bar  up  to  desired  title,  then  press  the ENTER key to open related
  464. document.
  465.  
  466.                     **************************************
  467.                     ENTER key to OPEN highlighted Document
  468.                     **************************************
  469.  
  470.  
  471.  
  472.  
  473.  
  474. Document Window
  475. ===============
  476. Once in Document window press Alt-H keys to get the following help:
  477.  
  478.                    Help - DOCUMENT Window Available Commands (3rd)
  479.                    ===============================================
  480.  
  481.     Alt-A  Automatic Scroll On/Off       PgDn/Up   Page Down/Up
  482.     Alt-F  Write Document to File        /       Line Up/Down
  483.     Alt-M  Mark Document Position        Home/End  To/Bottom List
  484.     Alt-J  Jump to Mark (Alt-M)          -/+       Dec/Incr Scroll Speed
  485.     Alt-P  Print Document                F1        Search String
  486.     -/-  Keyword Navigation            F2        Search Again
  487.     ─┘    Open Keyword                  ESC       Exit
  488.  
  489.  
  490. Up/Down  arrows,  PgUp/PgDown  and Home/End keys allow you to quickly navigate
  491. across Document Window.
  492.  
  493.               **************************************************
  494.               Up/Down,PgUp/PgDown,Home/End to navigate DOCUMENTS
  495.               **************************************************
  496.  
  497.  
  498. While Left/Right arrows let you navigate through keywords (if they exist)
  499.  
  500.  
  501.                     **************************************
  502.                     Left/Right Arrows to navigate KEYWORDS
  503.                     **************************************
  504.  
  505.  
  506.  
  507.  
  508. Reading Long Document
  509. =====================
  510. Reading  long  document  you  need  some  functions  to  emulate the real book
  511. reading.
  512.  
  513.  
  514. The  first  one  is to mark a position for latter retrieve. Use Alt-M when you
  515. want  stop  reading  at  a  specific position (a soft beep advises you of work
  516. done).  Once  you are back to same document use Alt-J to jump to mark. With no
  517. mark, Alt-J jumps to first document line.
  518.  
  519.             ******************************************************
  520.             Alt-M and Alt-J to MARK a position for later retrieval
  521.             ******************************************************
  522.  
  523.  
  524. If  you want to read document without using arrows for navigation, you can use
  525. the  Alt-A  automatic  scroll  option. VISION has a default value of 7 seconds
  526. delay  time  between  scrolling (see in VISION.CFG the SCROLL_SPEED option) so
  527. that you can read it relaxed and quite.
  528.  
  529. Use  plus  key  (+)  to slow down scrolling speed or minus (-) key to increase
  530. such a speed.
  531.  
  532.  
  533.  
  534.  
  535. Keyword Window
  536. ===============
  537. Once in the a Keyword Window, press Alt-H keys to get following Help:
  538.  
  539.  
  540.                    Help - MAIN Window Available Commands
  541.                    =====================================
  542.  
  543.     -/-  Keyword Navigation                         Alt-H    This Help
  544.     ─┘    Open Keyword                               ESC      Exit
  545.  
  546.  
  547.  
  548. Because  in  a  Keyword  Window  you  can  find other keywords, use Left/Right
  549. arrows  to  navigate these new keywords. You can have up to 16 Keyword Windows
  550. in depth.
  551.  
  552.            ********************************************************
  553.            Up to 16 Keyword Windows in depth for each DOCUMENT word
  554.            ********************************************************
  555.  
  556.  
  557.  
  558.  
  559. How Many Keyword Windows
  560. ------------------------
  561. When  at document level (3rd layer), each word can be a keyword. If a document
  562. has  for  example  1000  words,  you can have at the maximum 1000 keywords for
  563. this  level.  Once  open  one  of  these  1000  keyword, you enter FIRST LEVEL
  564. Keyword  Window where you can find other keywords (in a Keyword Window you can
  565. find  about a maximum of 100 words). Then you can choice one of them and enter
  566. in  the  SECOND LEVEL Keyword Window, and that up to 16 LEVELS Keyword Windows
  567. in depth.
  568.  
  569.  
  570. If  we  have  for  example  a Data Base with 100 documents, each document with
  571. 1000  words and assume that each of them are a keyword, and each of them opens
  572. a  FIRST  level  window with about 100 keywords per window, up to 16 LEVELS in
  573. depth,  the  maximum number of Keywords Windows we can have for that Data Base
  574. is the following :
  575.  
  576.  
  577.                           100x1000x100x16=16,000,000
  578.  
  579.  
  580.  
  581.  
  582.  
  583. VISION Data Base Technical Structure
  584. ====================================
  585. VISION  System  works  using  two  different  files,  the index file with .NDX
  586. extension  and  data  base  file  with  .DB  extension. If Data Base uses also
  587. keyword option, VISION creates in this case a third file with .KEY extension.
  588.  
  589.  
  590. The following is its structure :
  591.  
  592. 1) Index record title (78 bytes 78 character)
  593. 2) Physical DB address (2 bytes integer)
  594. 3) Length of document  (4 bytes long integer)
  595. 4) Position of the Mark (2 bytes integer)
  596. 5) Reserved for later use (2 bytes integer)
  597.  
  598.  
  599. The Data Base structure is very simple :
  600.  
  601. 1) Comment line (78 bytes 78 characters)
  602.  
  603.  
  604. But  you  have  to  don't care at all of this technical info, you have only to
  605. follow these very simple instructions to create your new data base.
  606.  
  607.  
  608.  
  609.  
  610.  
  611. Creating New Free Form Textual Data Base
  612. ========================================
  613.  
  614.  
  615. A) Building New Source ASCII File
  616. ---------------------------------
  617. Take  your  favorite  Text Editor or use Alt-E option from Main Menu to edit a
  618. new  source  file  called  i.e. #_PIPPO.UPD (the .UPD extension is a MUST) and
  619. write your info in the following order :
  620.  
  621. 1) First row will become FIRST index record
  622.  
  623. 2)  from  second  line up to the special break-characters line, write document
  624. lines  with  a  maximum  of  78  characters  (pay attention to don't write the
  625. following special combination of characters '@#$' at the line beginning).
  626.  
  627. 3)  special break-string combination to close the document; that is a '@#$' at
  628. the beginning of the line.
  629.  
  630. Look at the following simple #_PIPPO.UPD example :
  631.  
  632.  
  633.                    ---beg of file----- (don't insert this line in your file)
  634. NETWORK
  635. ========
  636. The network is....
  637. ..................
  638. ..................
  639. [@#$]              (Don't write these squared brackets in real file)
  640. SUPER-CENTER
  641. ============
  642. The supercenters are....................................
  643. ........................................................
  644. ........................................................
  645. ........................................................
  646. ........................................................
  647. ........................................................
  648. [@#$]              (Don't write these squared brackets in real file)
  649. PROTOCOLS
  650. =========
  651. You need protocols when you
  652. have to exchange information with other people/computers.
  653. The language is one of above protocols.
  654.                    ---end of file----- (don't insert this line in your file)
  655.  
  656.  
  657.           **********************************************************
  658.           DON'T insert the break-string at the BEGINNING of the file
  659.           **********************************************************
  660.  
  661.              ****************************************************
  662.              DON'T insert the break-string at the END of the file
  663.              ****************************************************
  664.  
  665.           ***********************************************************
  666.           DON'T put BLANK lines between break-string and FIRST record
  667.           ***********************************************************
  668.  
  669.  
  670.  
  671.  
  672.  
  673. B) Creating VISION format Data Base
  674. -----------------------------------
  675. Once  done  this  ASCII  test  file, on VISION Main Menu, press Alt-B keys and
  676. give  its filename without any extension. This file MUST reside in same VISION
  677. directory.
  678.  
  679.             ******************************************************
  680.             .UPD source files MUST be in the same VISION directory
  681.             ******************************************************
  682.  
  683.  
  684. You  can  also  use  VIS_CRE program at DOS level without entering VISION Main
  685. Menu :
  686.  
  687.                            C:\VISION\vis_cre #_pippo
  688.  
  689.  
  690. This  program  creates  #_PIPPO.NDX  with three master records (NETWORK,SUPER-
  691. CENTER,PROTOCOL) and the #_PIPPO.DB data base with text.
  692.  
  693.  
  694. After  VISION has created these two files, it asks for a DB comment line. (You
  695. can  also  change  this  comment  later,  on  Main  Menu  press  Alt-C keys on
  696. highlighted name).
  697.  
  698.  
  699.  
  700. See  and  use  this  example  to understand how to build or to modify a source
  701. ASCII  .UPD  file.  #_PIPPO.UPD  must  be  in  the VISION delivery disk or ZIP
  702. archivie.
  703.  
  704.           ***********************************************************
  705.           USE #_PIPPO.UPD file to understand how to build a VISION DB
  706.           ***********************************************************
  707.  
  708.  
  709.  
  710.  
  711.  
  712. New Data Base from existing ASCII File
  713. ======================================
  714. This  procedure  is  the most common use of VISION because you have often some
  715. .DOC/.MAN/.TXT/.HLP  files  in printable or listable ASCII format and you want
  716. to  transform  them in the more readable VISION format. VISION can very easily
  717. transform this ASCII files in a Textual Free Form Data Base.
  718.  
  719.            ********************************************************
  720.            VISION can quickly transform ASCII files in FREE FORM DB
  721.            ********************************************************
  722.  
  723.  
  724.  
  725. A) Modifying Source ASCII File
  726. ------------------------------
  727. Take  the ASCII file you want to convert and rename it with the .UPD extension
  728. (i.e.  PIPPO.DOC  in  #_PIPPO.UPD);  remove  all extraneous lines (top of form
  729. character,  page  break, etc.) and do exactly the same procedure as to build a
  730. new VISION source .UPD file.
  731.  
  732.  
  733.  
  734. Example of #_PIPPO.UPD ASCII file to convert
  735. ------------------------------------------
  736.  
  737.  
  738.                          - Pag 1 -
  739.  
  740. NETWORK
  741. ========
  742. The network is....
  743. ..................
  744. ..................
  745.  
  746. TOF (Top of Form printer command)
  747.  
  748.                          - Pag 2 -
  749.  
  750. SUPER-CENTER
  751. ============
  752. The supercenters are....................................
  753. ........................................................
  754. ........................................................
  755. ........................................................
  756. ........................................................
  757. ........................................................
  758.  
  759. TOF (Top Of Form printer command)
  760.  
  761.                          - Pag 3 -
  762.  
  763. PROTOCOLS
  764. =========
  765. You need protocols when you
  766. have to exchange information with other people/computers.
  767. The language is one of above protocols.
  768.  
  769.  
  770.  
  771.  
  772.  
  773. Now  remove  ALL  EXTRANEOUS  lines,  i.e.  the  "Pag  nn"  lines,  the  "TOF"
  774. characters,  the  blank  not  useful  lines, then follow the same procedure as
  775. before  to  create  new  source file so that the original PIPPO.DOC looks like
  776. the following #_PIPPO.UPD file :
  777.  
  778.  
  779.                    ---beg of file----- (don't insert this line in your file)
  780. NETWORK
  781. ========
  782. The network is....
  783. ..................
  784. ..................
  785. [@#$]              (Don't write these squared brackets in real file)
  786. SUPER-CENTER
  787. ============
  788. The supercenters are....................................
  789. ........................................................
  790. ........................................................
  791. ........................................................
  792. ........................................................
  793. ........................................................
  794. [@#$]              (Don't write these squared brackets in real file)
  795. PROTOCOLS
  796. =========
  797. You need protocols when you
  798. have to exchange information with other people/computers.
  799. The language is one of above protocols.
  800.                    ---end of file----- (don't insert this line in your file)
  801.  
  802.  
  803.  
  804. Once  PIPPO.DOC  has  been modified in this #_PIPPO.UPD way, enter VISION Main
  805. menu and press Alt-B keys to generate new DB.
  806.  
  807.  
  808.  
  809.  
  810.  
  811. Updating an Existing Data Base
  812. ==============================
  813. The best way to update a VISION DB is to :
  814.  
  815. 1) enter VISION Main Menu (1st level)
  816. 2) move the bar to Data Base name
  817. 3) press Alt-U keys and confirm
  818.  
  819. Now VISION creates again original .UPD source file, then :
  820.  
  821. 4) exit VISION (ESC key)
  822. 5) use your preferred Text Editor to UPDATE source .UPD file
  823. 6) enter again VISION
  824. 7) Alt-B keys to update VISION Data Base (.DB, .NDX and eventually .KEY)
  825.  
  826. or with Alt-E option :
  827.  
  828. 4) Alt-E to edit .UPD just created source file
  829. 5) Alt-B keys to update VISION Data Base (.DB, .NDX and eventually .KEY)
  830.  
  831.  
  832.  
  833.  
  834. Erasing Data Base
  835. =================
  836. Enter  VISION  Main  Menu,  move  bar on Data Base to remove, then press Alt-D
  837. keys.  VISION  removes  only  .DB,  .NDX and .KEY files; it doesn't delete the
  838. .UPD source ASCII file.
  839.  
  840.  
  841.  
  842.  
  843.  
  844. Sort Option
  845. ===========
  846. You  can  have  the list of available TDB (Textual Data Bases) sorted in three
  847. different ways (first Menu Window).
  848.  
  849. Write in VISION.CFG file your sorting choice.
  850.  
  851. SORT=BYNAME        It sorts Data Bases by names.
  852. SORT=BYDATE        It sorts Data Bases by date (last equal first)
  853. SORT=NO            VISION doesn't make any sort.
  854.  
  855. Using  SORT=NO  and  VISION.DIR  option,  you  can decide by yourself the Data
  856. Bases order (thus you get in main Window the exact order of VISION.DIR file).
  857.  
  858.  
  859.  
  860.  
  861. Changing the Main Menu List
  862. ===========================
  863. Renaming  BOTH  files  (.NDX  and .DB file) with a name of your choice, VISION
  864. sorts  automatically  them  by  new  alphabetical  order  putting  them in the
  865. position you prefer (if the sorting option is set on BYNAME).
  866.  
  867.  
  868. For example :
  869.  
  870. N_......  = network related data bases
  871. P_......  = product related data bases
  872. S_......  = services
  873. V_......  = various and generic data base
  874. $_......  = pricing data bases
  875. ..  = ...............................
  876.  
  877.  
  878.  
  879. Simply  changing the name of your DB (and related .NDX and .KEY file), you get
  880. a  different  classification. For example if you want to put #_PIPPO Data Base
  881. in  first Main Menu line, execute the following DOS command, at DOS prompt, in
  882. the VISION directory :
  883.  
  884.                      C:\VISION\rename #_pippo.* !_PIPPO.*
  885.  
  886. to be sure to change all #_PIPPO DB related files.
  887.  
  888.  
  889.  
  890.  
  891.  
  892. Directory Option
  893. ================
  894. When  VISION starts, it firstly look for a file called VISION.DIR. So that you
  895. have two different VISION behavior :
  896.  
  897. 1) VISION doesn't find it in current directory.
  898.    Then VISION looks for files on current directory as usual.
  899.  
  900. 2) VISION finds this file. Then it uploads DBs into Main Menu following
  901.    VISION.DIR directive.
  902.  
  903. In  the  last  way you can have your VISION files anywhere in your PC. Look at
  904. the example for a better understanding.
  905.  
  906.        *****************************************************************
  907.        Using VISION.DIR option you can have DB files ANYWHERE in your PC
  908.        *****************************************************************
  909.  
  910.  
  911.  
  912. VISION.DIR example
  913. ==================
  914. D:\VISION\#_VISION   (.DB .NDX and .KEY files on current dir)
  915. C:\BIBLE\B_NEWT      (.DB .NDX and .KEY files on C:,in \BIBLE\ dir)
  916. G:\V_PRESS           (.DB .NDX and .KEY files on G:\, optical disk)
  917.  
  918.             *******************************************************
  919.             YOU MUST GIVE THE FULL PATH (DEVICE,DIRECTORY and NAME)
  920.             *******************************************************
  921.  
  922.  
  923. You  have  to  build  that  VISION.DIR  file using your preferred text editor.
  924. VISION.DIR  must  reside in the same VISION programs directory. Give a look to
  925. VISION.DDD, an example file in the distribution disk.
  926.  
  927.  
  928. When  you  load  a new data base, remember to update VISION.DIR file otherwise
  929. the program will ignore it.
  930.  
  931.               **************************************************
  932.               REMEMBER to UPDATE VISION.DIR when adding a new DB
  933.               **************************************************
  934.  
  935.  
  936.  
  937.  
  938.  
  939. To Create Hypertext Document
  940. ============================
  941. To build document in HyperText way you have to remember three main things :
  942.  
  943. 1) how to declare a SOURCE keyword
  944. 2) how to mark a TARGET keyword
  945. 3) how to write a Keyword WINDOW
  946.  
  947.  
  948.  
  949. HyperText Parameters in VISION.CFG
  950. ----------------------------------
  951. Give  a  look  at  VISION.CFG file (TYPE it or use a Text Editor). You have to
  952. find the following parameters:
  953.  
  954. WDW_EWND=@@@       this means you declare this three characters as the
  955.                    break-string to let VISION understand where a Keyword
  956.                    Window text stops.
  957.  
  958. SKD_LFT=60         source keyword left delimiting character
  959. SKD_RGT=62         source keyword right delimiting character
  960.                    these characters delimit the text word you want be
  961.                    a text keyword
  962.  
  963. TKD_LFT=17         target keyword left delimiting character
  964. TKG_RGT=16         target keyword right delimiting character
  965.                    for each SOURCE keyword you have to declare a TARGET
  966.                    keyword using these two delimiting characters
  967.  
  968.  
  969. Now  an  example. Let's imagine to have the example as before (#_PIPPO.UPD) to
  970. which we want add HyperText facility. Call this new file #_PLUTO.UPD.
  971.  
  972.                  *********************************************
  973.                  See #_PLUTO.UPD file for an Hypertext Example
  974.                  *********************************************
  975.  
  976.  
  977.  
  978.  
  979.  
  980.                    ---beg of file----- (don't insert this line in your file)
  981. NETWORK
  982. ========
  983. The <network> is....(here "network" is the 1st SOURCE keyword)
  984. ..............................................................
  985. ..............................................................
  986. [@#$]              (Don't write these squared brackets in real file)
  987. SUPER-CENTER
  988. ============
  989. The <supercenters> are............ (2nd SOURCE keyword)
  990. .......................................................
  991. .......................................................
  992. .......................................................
  993. .......................................................
  994. .......................................................
  995. [@#$]              (Don't write these squared brackets in real file)
  996. PROTOCOLS
  997. =========
  998. You need <protocols> when you  (3rd SOURCE keyword)
  999. have to exchange information with other people/computers.
  1000. The <language> is one of above protocols. (4th SOURCE keyword)
  1001. [@#$]              (Don't write these squared brackets in real file)
  1002. Hypertext Notes
  1003. ---------------
  1004. network          (1st TARGET keyword)
  1005. With Network word we intend here a Telecommunication Network.
  1006. Also called <VAN>.
  1007. [@@@]              (Don't write these squared brackets in real file)
  1008. supercenters
  1009. A Supercenter has clusters of processors, hundreds of disk devices.
  1010. For this reason we use to call them Supercenter.
  1011. [@@@]              (Don't write these squared brackets in real file)
  1012. protocols
  1013. See <protocol>
  1014. [@@@]              (Don't write these squared brackets in real file)
  1015. language
  1016. Usually  in Information Technology we use to call language a source high level
  1017. group of rules to be translated in machine sequence of binary symbols.
  1018. [@@@]              (Don't write these squared brackets in real file)
  1019. VAN
  1020. It  stands for Value Added Network. Differs from carrier because of some added
  1021. features like a protocol conversion, etc.
  1022. [@@@]              (Don't write these squared brackets in real file)
  1023. protocol
  1024. It's a group of rules to let participants to understand each other.
  1025.                    ---end of file----- (don't insert this line in your file)
  1026.  
  1027.  
  1028. We  have  declared  network  as  the first SOURCE keyword. We've enclosed this
  1029. word  between  "<"  (decimal 60 as in CONFIG.SYS in SKD_LFT parameter) and ">"
  1030. (decimal  62  as  in  SKD_RGT). Now we have to put somewhere the corresponding
  1031. TARGET keyword. You can change in CONFIG.SYS these delimiting characters.
  1032.  
  1033.              ****************************************************
  1034.              For each SOURCE keyword a TARGET keyword MUST exists
  1035.              ****************************************************
  1036.  
  1037.  
  1038.  
  1039.  
  1040.  
  1041. In  #_PLUTO.UPD  example  we've  put  at  documents  end a new document called
  1042. "Hypertext  Notes"  where  we  can  write  all  Hypertext  TARGET keywords and
  1043. related texts.
  1044.  
  1045. We  have  here  to declare first TARGET text (in this case the word "network")
  1046. and  we  have  to enclose it between a "" decimal 17 (as in VISION.CFG in the
  1047. TKD_LFT  parameter)  and a "" decimal 16 (as in TKD_RGT parameter). Obviously
  1048. you can change these two characters in VISION.CFG.
  1049.  
  1050. After  TARGET  keyword  declaration  we  have to write below an explanation of
  1051. this  keyword  with following limits : no more than 78 characters per line, no
  1052. more than 20 lines per comment.
  1053.  
  1054.               ***************************************************
  1055.               KEYWORD WINDOWS limits are 78 characters x 20 lines
  1056.               ***************************************************
  1057.  
  1058.  
  1059. After  text  end  write three "@@@" (as in VISION.CFG in WDW_END parameter) to
  1060. let VISION understand where text stops.
  1061.  
  1062.              ****************************************************
  1063.              DON'T insert the break-string at the END of the file
  1064.              ****************************************************
  1065.  
  1066.  
  1067.  
  1068.  
  1069. Attention to break-string
  1070. -------------------------
  1071. When  you  are  using  HyperText capability, pay attention to the break-string
  1072. characters  of  HyperText  texts (usually three "@@@", decimal 64, declared in
  1073. VISION.CFG  in  the  WDW_END=xxx  option),  different  from  the  break-string
  1074. characters  for  VISION  texts  (they MUST be ALWAYS "@#$", dec 64, dec 35 and
  1075. dec 36).
  1076.  
  1077. You  have  the  option  to  change  the  HyperText  break-string  to  get more
  1078. flexibility  in  designing  you  HyperText structure. In fact in the "glossary
  1079. document"  case  you  need  to  have  each  VISION text be at the same time an
  1080. HyperText  text  too. In this case, declare the same VISION break-string (thus
  1081. "@#$")  in  WDW_END=xxx  parameter  in  VISION.CFG  file, for HyperText break-
  1082. characters.
  1083.  
  1084.        ****************************************************************
  1085.          Every time you're building a new doc with HyperText function
  1086.        VERIFY the break-string value on VISION.CFG in WDW_END parameter
  1087.        ****************************************************************
  1088.  
  1089.  
  1090.  
  1091.  
  1092.  
  1093. VISION Commamnd Line
  1094. ====================
  1095. You can execute VISION also from another program capable to SHELL to DOS.
  1096.  
  1097. To  do  that  you  have  only  to  execute  VISION  in command line mode, thus
  1098. VISION.EXE followed by data base name:
  1099.  
  1100.                            C:\VISION\VISION #_pippo
  1101.  
  1102.  
  1103.  
  1104.  
  1105. Changing Text Font
  1106. ==================
  1107. If  you  have a VGA monitor, you can change the ROM standard PC font. You have
  1108. to  execute before VISION a small utility VIS_FONT which loads a modern-d font
  1109. (use firstly VIS_FONT /D option) into PC ROM.
  1110.  
  1111.  
  1112. You  can change the font using instead of /d the /s "scrawled" hand made font,
  1113. or /l or no option for modern-s font.
  1114.  
  1115.  
  1116.  
  1117.  
  1118. PC Configuration
  1119. ================
  1120. You need any MS-DOS compatible Personal Computer with :
  1121.  
  1122. - at least 256 k Bytes of main memory
  1123. - hard disk
  1124. - video
  1125.  
  1126. better if :
  1127.  
  1128. - 640 K bytes of main memory
  1129. - VGA color video (the reading is easier)
  1130.  
  1131.  
  1132.  
  1133.  
  1134.  
  1135. History
  1136. =======
  1137.  
  1138.         4.1        - Added VIS_UPD.EXE to revert VISION Data Bases into
  1139.                      the original ASCII .UPD file.
  1140.  
  1141.                    - Fixed a bug while printing documents from a very large
  1142.                      Data base.
  1143.  
  1144.  
  1145.         4.2        - Fixed minor bug in main menu window when DBs are exactly
  1146.                      14 files.
  1147.  
  1148.  
  1149.         4.4        - 15 Data Base names on Main Menu instead of 14.
  1150.                      20 text rows on Text Windows instead of previous 19.
  1151.  
  1152.                    - No more RAM option.
  1153.  
  1154.                    - No more SOUND option.
  1155.  
  1156.                    - Added Data Base name SORT option.
  1157.  
  1158.                    - Slightly faster than 4.2 version.
  1159.  
  1160.  
  1161.         5.0        - Partially rewritten and recompiled used P.D.Q library
  1162.                      to have a complete assembler code. Much smaller than
  1163.                      before and faster.
  1164.  
  1165.                    - Added Hypertext Capability.
  1166.  
  1167.                    - Removed Alt-D shell to DOS.
  1168.  
  1169.                    - Added Alt-B to create new DB directly from Main Menu.
  1170.  
  1171.                    - Added Alt-E to edit source ASCII .UPD file.
  1172.  
  1173.                    - Added Alt-U to rebuild original source .UPD file.
  1174.  
  1175.                    - Added Alt-D to erase a DB from Main Menu.
  1176.  
  1177.                    - Each of four layers has each Help screen.
  1178.